###User Defined Function###
_Excel_PictureAdd

###Description###
Fügt ein Bild in das angegebene Arbeitsbuch und die Arbeitsblatt

###Syntax###
#include <Excel.au3>
_Excel_PictureAdd ( $oWorkbook, $vWorksheet, $sFile, $vRangeOrLeft [, $iTop = Default [, $iWidth = Default [, $iHeight = Default [, $bKeepRatio = True]]]] )

###Parameters###
@@ParamTable@@
$oWorkbook
	Excel Arbeitsbuch-Objekt
$vWorksheet
	Name, Index oder Arbeitsblatt-Objekt in das geschrieben werden soll. Wenn das Schlüsselwort Default gesetzt ist, wird das aktive Arbeitsblatt genutzt
$sFile
	Voller Pfad zur Bilddatei, welche hinzugefügt werden soll
$vRangeOrLeft
	Entweder ein A1 Bereich, ein Bereichs-Objekt oder eine Zahl, welche die linke Position der oberen, linken Ecke des Bildes festlegt
$iTop
	[optional] Wenn $vRangeOrLeft ein Integer ist, dann ist $iTop die obere Position der oberen, linken Ecke des Bildes
$iWidth
	[optional] Wenn angegeben, setzt es die Breite des Bildes. Wenn nicht angegeben, wird die Breite automatisch ermittelt (Standart = automatisch)
$iHeight
	[optional] Wenn angegeben, setzt es die Höhe des Bildes. Wenn nicht angegeben, wird die Höhe automatisch ermittelt (Standart = automatisch)
$bKeepRatio
	[optional] Wird nur genutzt, wenn die $vRangeOrLeft ein Mehrfachzellen-Bereich ist (Standart = True)
		Bei True wird das Seitenverhältnis in den Grenzen des durch $vRangeOrLeft definierten Bereiches erhalten.
		Bei False wird der durch $vRangeOrLeft definierte Bereich ausgefüllt, unabhängig vom originalen Seitenverhältnis (und dadurch das Bild ev. verzerrt).
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Ein Formobjekt (Shape), das das neue Bild darstellt
Fehler:	0 und setzt @error.
@error:	1 - $oWorkbook ist kein Objekt oder kein Arbeitsbuch-Objekt
	2 - $vWorksheet Name oder Index ist falsch oder $vWorksheet ist kein Arbeitsblatt-Objekt. @extended ist gesetzt auf den COM Fehlercode
	3 - $vRangeOrLeft ist falsch. @extended ist auf den COM Fehlercode gesetzt
	4 - Ein Fehler trat beim Hinzufügen des Bildes auf. @extended ist auf den COM Fehlercode gesetzt
	5 - $sFile existiert nicht
@@End@@

###Remarks###
Wenn $vRangeOrLeft ein Bereich mit mehreren Zellen ist, wird $iWidth und $iHeight ignoriert (um Breite/Höhe des Bildes nicht basierend auf der Breite/Höhe des Bereichs anzugeben, gibt eine einzelne Zelle in $vRangeOrLeft an).

Wenn nur Breite oder Höhe angegeben ist, so wird der fehlende Wert (auf Standard gesetzt) skaliert um das Format des Originalbildes beizubehalten.
Wenn beide, Breite und Höhe, angegeben sind, wird das Bild die angegebenen Werte ungeachtet des originalen Formates nutzen.
Wenn weder Breite, noch Höhe angegeben sind, wird das Bild automatisch auf die Größe des Original Bildes skaliert.

$bKeepRatio wird ignoriert, wenn kein Range über mehrere Zellen angegeben wurde (siehe Parameter für Details).

###Related###
Keine.

###Example###
@@IncludeExample@@
